home *** CD-ROM | disk | FTP | other *** search
/ Informática Multimedia 1995 April / Informatica Multimedia CD - Epimundo.iso / DOS / ARCHIVE / CRUNCH.ZIP / README < prev    next >
Encoding:
Text File  |  1988-12-15  |  3.5 KB  |  74 lines
  1.  
  2.  Program Name:  Crunch
  3.  
  4.         Usage:  Crunch outputfile[.arc] [inputfile [...]]
  5.  
  6.       Purpose:  Create archive files using LZW 12-bit compression that are
  7.                 compatible with those produced by PKWare and SEA programs.
  8.  
  9.  
  10. Program Notes:
  11.  
  12.     *  This program does NOT update or freshen an archive.  It can only be
  13.        used to create NEW archives!
  14.  
  15.     *  If no input file specifications are provided on the command line, the
  16.        program assumes *.*
  17.  
  18.     *  Only two stowage methods are supported by this program...they are
  19.  
  20.             Crunching:  Input is first "packed" to remove repeated character
  21.                         sequences and is then compressed using 12-bit LZW
  22.                         compression techniques.  Adaptive resets of the
  23.                         algorithm's code table may also be utilized.
  24.  
  25.               Storing:  The input file is copied into the archive with no
  26.                         compression applied.
  27.  
  28.     *  Files will be "stored" in the resulting archive if the program's
  29.        crunching routine does not produce a smaller result.
  30.  
  31.     *  13-bit "squashing" has not been implemented in this program.  It has
  32.        been left as an exercise for the student (see the file Squash.How for
  33.        some hints on how to proceed).
  34.  
  35.     *  I originally wanted to release full Turbo Pascal source code for the
  36.        program.  Unfortunately, the "all TP" version was slower than
  37.        mollasses on a cold day.  I therefore re-coded several routines
  38.        within the program using inline assembler.  The asm stuff is heavily
  39.        commented, but if it still looks like gobbledygook to you, I
  40.        apologize.  The intent was to release this package as both an
  41.        educational tool and as a program that did useful work.  The only way
  42.        that the second objective could be realized was to replace certain
  43.        critical routines with something a little faster than what the TP
  44.        compiler could provide.
  45.  
  46.     *  Be careful...this TP 5.0 program was compiled with the "force far
  47.        calls" option turned ON.  The inline routines rely on this fact. If
  48.        you compile with this option turned OFF, the results will be
  49.        unpredictable.
  50.  
  51.     *  The author of the programs contained within CRUNCH10.ARC makes no
  52.        claim as to the correctness or suitability of these programs for any
  53.        particular purpose whatsoever.  If you use these programs or the
  54.        algorithms from which they were derived, you must assume all
  55.        responsibility for the consequences of that use.
  56.  
  57.     *  The routines presented in Crunch.Pas were derived from the lzcomp.asm
  58.        and lzdcmp.asm programs written and released by Tom Pfau back in
  59.        1985.  The programs in this archive are yours...do with them what you
  60.        will, but please note that System Enhancements Associates (SEA)
  61.        regards ARC as their trademark.  Should you wish to use the Crunch
  62.        source code in your own program, I suggest you contact SEA for
  63.        licensing details and restrictions.  I WILL NOT ACCEPT any
  64.        responsibility for any legal problems that may arise as a result of
  65.        the use or misuse of the ARC processing code contained in Crunch.  I
  66.        do not have any agreement myself with SEA;  SEA has indicated that
  67.        public domain programs may process .ARC files without any
  68.        restrictions.
  69.  
  70.  
  71.                                                   Richard P. Byrne (rpb)
  72.                                                         12/15/88
  73.  
  74.